home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2000 February / Macworld (2000-02).dmg / Shareware World / Utilities / Disk & File / FolderSync 1.6.5 / Read Me < prev    next >
Text File  |  1999-11-17  |  18KB  |  198 lines

  1.  
  2.  
  3.  
  4.  
  5. FoldersSynchronizer 1.6.5  - by Lorenzo Puleo, 17 November 1999
  6.  
  7. Shareware Utilities for Macintosh. Choose two or more folders/disks and then they will be synchronized exaclty. The old files will be replaced with the newest files  in both the directions. The new files (new entries) will be copied in both the directions, as well as the new Folders.
  8. The old Folders will not replaced entirely by the newer, as the Finder used to do, but their content will be updated with the newest files, the new files (new entries) and new Folders(new entries). 
  9. • FS can filter the documents to copy by Type, Creator and Modification Date.
  10. • FS can do multiple synchronizations or backups from your custom list.
  11. • FS can do syncs/backups at the time specified in the timer list.
  12. • FS can copy invisible Files and Folders.
  13. Before use it, try it on two trial folders in which there are subfolders and files.
  14. FoldersSynchronizer cannot Undo the process. Scriptable by AppleScript.
  15.  
  16.  
  17. Requirements for Macintosh:
  18. Power Macintosh (PPC version) or All Macintosh (FAT version)
  19. MacOs 7.0.1 or higher
  20. 7 Mb of free RAM
  21. 2.3 Mb free on disk
  22. 14" Color Monitor
  23.  
  24.  
  25. What's new in the 1.6.5 version
  26. • FS can copy also invisible Files and Folders.
  27. Go to the Preferences area and mark the check-box "Invisible Items" to let FS consider these items when working.
  28. • FS considers also files like "OpenFolderListDF" which have a Carriage Return at the end of the filename.
  29.  
  30.  
  31. What's new in the 1.6 version
  32. • FS can start BackUps and Synchronizations at the specified time.
  33. You can choose 7 timers specifying Hour, Minutes and the day of the week (on Monday, on Tuesday,... or Every Day).
  34. You have to leave FoldersSynchronizer open, if you want Syncs/Backups start automatically at the time specified.
  35. FS checks the timer list every 10 seconds (in multitasking mode), only if the "Timer On" check-box is marked and the current area is the consolle (the window with the 2 big arrows).
  36. If some error occurs, FS will stop the current task and will switch the Timer to off to prevent any next trouble.
  37. When you apply the timer list, FS will not consider, as today tasks, the today timers which are less or equal to the current system time.
  38. If the system is busy, FS will wait to take the control, then it will execute in background mode the syncs/backups not yet done.
  39. • There is a new menu "Option". It contains the menu items: Preferences, Filters, Multiple List, Timer.
  40. • The preference file name is now "FoldersSynchronizer 1.6 Prefs"
  41.  
  42.  
  43. What's new in the 1.5 version
  44. • FS can do multiple synchronizations or backups from your custom list. For now, max 7 synchronizations or backups are available at one time. Click on the blue "m" icon to set your multiple list.
  45. • FS saves and reloads your multiple lists.
  46. • FS shows the ShortLog window (by request) with multiple pages.
  47.  
  48.  
  49. What's new in the 1.4.2 version
  50. • Now FS works fine also with MacOS German version on old SCSI disks.
  51.  
  52.  
  53. What's new in the 1.4.1 version
  54. • In the "Info" area there is a new check-box: "Exact BackUp". If checked (only together with "One direction only"), FS will delete, from the Bottom Folder, all the Files and all the Folders that no longer exist in the Top Folder. 
  55. This way, the Bottom Folder will be an exact copy of the Top Folder, as the Finder has replaced the entire content of the Bottom Folder. 
  56. FS, which operates differently from the Finder, will copy only the Files and the Folders which really need to be copied, deleting in the Bottom Folder the Files and the Folders that no longer exist in the Top Folder, and therefore will take less time in the Finder. Moreover, the Filters can work together with this option. e.g. If you define a filter, FS will copy (or skip) and will delete (or skip) only those Files which match that filter.
  57. Use this option with care. THERE IS NO WAY TO UNDO THIS PROCESS!
  58.  
  59.  
  60. What's new in the 1.3 version
  61. • Some tasks run faster than previous versions (Scan Folders and Sync Files).
  62. • In the "Info" area there are two new check-boxes: "Beep when done" and "Save Log File".
  63. • The progress bar now appears as a 3D shadow standard Macintosh.
  64. • The "RegistrationFile.txt" has changed. The 1.x registered users can get the new "RegistrationFile.txt" free, by request to archidea@tin.it, specifying Registered Name and Email as they appear in the previous registered versions. No "RegistrationFile.txt" will send to different email addresses.
  65. • The preference file name is now "FoldersSynchronizer 1.3 Prefs"
  66.  
  67.  
  68. What's new in the 1.2 version
  69. • FS shows an infinite progress bar when it scans the folders looking for files to copy. So, when you apply some filters and FS scans a folder with many files but few files specified by filters, you can be sure that FS is working.
  70. • You can click also on the radio-button labels to activate them.
  71. • You can use the Enter, the Return and the Escape keys in the Filters area.
  72.  
  73.  
  74. What's new in the 1.1 version
  75. • The "RegistrationFile.txt" goes into the "PlugIn" folder. Please take your old "RegistrationFile.txt" from your old version and place it into the "PlugIn"  folder.
  76. • FS 1.1 can now filter the documents to copy by Type, Creator and Modification Date.
  77. See below the section "Use the filters".
  78. • If you hold down the option key when launch FS (until the splash screen appears, and two seconds more), FS will skip the old saved Preference file. In any case, the old preference file "SyncroPref10.txt" is no long considered by FS 1.1. You could also delete this file.
  79.  
  80.  
  81. Working with FoldersSynchronizer 1.6.5
  82. • Launch the application "FoldersSynchronizer".
  83. • Pick the 1st Folder by clicking on the Top Folder Icon.
  84. • Pick the 2nd Folder by clicking on the Bottom Folder Icon.
  85. • Click on button "Synchronize" to launch the process. You can stop the process at any time.
  86. • By clicking on the blue icon "i" at the bottom-right, you can set the check-box "Remember Folders" which allows FoldersSynchronizer to remember the last two Folder chosen, so you can avoid to pick the two folders every time you need to Synchronize or BackUp. This is recommended for advanced users (someone could synchronize two unwanted folders). It's most useful when you control this application by AppleScript. See below the Apple Scripts section.
  87. • The 2th check-box "One direction Only" turns FoldersSynchronizer into a BackUp program. The big orange arrow on the left will change into a gray arrow. The Bottom folder will be upgraded with the newest files and folders
  88. coming from the Top folder, and the Top Folder will be left untouched.
  89. • Whenever FoldersSyncronizer meets conflicts between FolderNames and FileNames (e.g. it tries to copy the file "MyJob" into a folder in which there is the folder "MyJob"), it first renames automatically the FileName appending the suffix ".1", ".2", ".3", .etc, and then it copies the file. Even if the file is coming from the source folder during a BackUp, it will be renamed. So, before when we said "the Top Folder will be left untouched", we meant no deleting or movement.
  90. • Remember that FoldersSyncronizer cannot revert the process. There is not UNDO command. Therefore, to prevent any troubles, use this application with care.
  91. • At the end of the process, FoldersSyncronizer saves a Text Log File into the folder "Log Files" which describes each task done and a summary of files copied, replaced or renamed and Folders created for both the main folders chosen. FS will create the folder "Log Files", if it's needed. The filename of the Log file shows e.g. Bckp_1999_09_23_00_10_05. The format is "Bckp" for BackUps, "Sync" for Synchronizations. After, the date and time, YYYY_MM_DD_HH_MM_SS.
  92. • If during the synchronization or BackUp an error occurs (e.g. a file is write-protected and FS cannot overwrite it), FS will advise you by an alert-box showing which file or folder is causing trouble, and will stop the entire process. At the bottom of the Log file, you will find the line in which the error occurred (e.g. Error copying file "MyDisk:Jobs:myFile" into "Server:BackUp:Jobs:myFile). Solve your problem (e.g. the disk is full) and then re-launch the process.  FS restarts from the first item, but will quickly skip the items already updated.
  93. • The user can stop the entire process by clicking on the button "Stop". The file Log will report this action by the user.
  94. Again, you can re-launch the process. FS restarts from the first item, but will quickly skip the items already updated.
  95. • If you need to work with thousands of files and FS quits before the process is complete, try to increase the application memory in the Finder application's  Get Info box (command-i).
  96. • Do not modify, move or rename the "PlugIn" folder.
  97.  
  98.  
  99. Using the Filters
  100. • Since FS 1.1, you have been able to FILTER your documents to copy. Click on the blue icon "f" at the right of the console to go to the filters area.
  101. • Click on the check-box "Filter on" to active the filter window.
  102. • Click on the icon "File" to import Type and Creator from a file chosen in only one step.
  103. • Click on the single cell (Type or Creator) to import only the Type or only the Creator.
  104. • Hold down the option key and click to erase the single cell.
  105. • Hold down the option key and click on the "File" icon to erase Type and Creator in only one step.
  106. • You can also erase all the cells in only one step by clicking on the "Little Trash" icon.
  107. • Click on the cell "On" (first column at left) to activate/deactivate the single filter. The inactive filters will be shown grayed out.
  108. • You can choose to copy only the documents that match the filters list, or skip them and copy all of the rest.
  109. e.g. If you want to copy all the documents in your folders, but not the applications, pick the "Type" from any application ("APPL") and mark the radio-button "Skip only..." (it thinks: if you find an application, don't copy it, skip it - copy the rest)
  110. • Always click to the button "Apply" to confirm your changes to the filters list and filters preferences.
  111. • When you come back to the console and the filters are on, the blue icon "f" will change in light green/blue, so you can always tell when the filters are on. 
  112. • If you want to copy only the files with a modification date you specify, click on the cell "Date" to set the date. By default, FS will insert the operator ">=" (all the files with the modification date greater than or equals to...). You could "rotate" the 5 operators (>, >=, =, <=, <) by clicking on the cell "Op.". To delete the date, hold down the option key and click on the cell "Date".
  113. • Every single row is ONE filter and its parameters work as an "AND" combination. For example (the "Copy only..." radio button is marked): "Copy the files only if the Type is "TEXT" AND the Creator is "ttxt" AND the
  114. Modification Date is equal to 29 sept 1999". FS will copy ONLY the files whose satisfy ALL of these conditions .
  115. If only one of this condition is not satisfied, FS will not copy the file.
  116. • If you specify more than one filter, every filter works as explained above,  but you add an "OR" combination between filters. E.g.: if the first filter doesn't match the file, but the second filter yes, FS will copy the file.
  117. E.g. If you want to copy all the TIFF type plus all the today's files (TIFF and not TIFF...), you have to specify 2 filters:
  118. 1st filter: Type = TIFF
  119. 2nd filter: Date = Today (dd mmm aaaa)
  120.  
  121.  
  122. Apple Events
  123. • AppleScript can manage the process. See the 2 samples into the "AE Applet Samples" folder included in this package.
  124. Try to substitute the folders paths with your folders paths.
  125.  
  126.  
  127. Disclaimer
  128. • The authors of this software make no warranties, either express or implied, regarding the fitness of this or any version of FoldersSynchronizer for any particular purpose. Use FoldersSynchronizer at your own risk. The authors accept no liability for data loss or other problems caused directly or indirectly by FoldersSynchronizer.
  129. • The author is not responsible for any damage regarding lost data, damage of the archives, and any other trouble coming from the use of this software. The user, accepts these terms.
  130.  
  131.  
  132. Suggestions
  133. • Please, feel free to send to me your wish list and suggestions about FS's features to my email-boxes:
  134. archidea@tin.it  (or) puleo@kagi.com
  135. Any suggestion coming from the users could be implemented in the next releases. 
  136.  
  137. ----------------------------------------
  138. About Pricing:
  139. "FoldersSynchronizer" has the following pricing:
  140. 1-5 single user licenses, $20 per user (US Dollars)
  141. 6-9 single user licenses, $18 per user
  142. 10 or more single user licenses, $17 per user
  143.  
  144. A Site License costs $400 and covers all locations for your organization within a 160 kilometer radius of your site (100 miles). One big advantage of a Site License is that you do not need to keep track of how many people at your site are using the software. 
  145. A World-Wide License costs $1600 and it covers all locations for your organization on the planet earth.
  146.  
  147.  
  148. About Registration:
  149. Paying for the FoldersSynchronizer is fairly simple. There are two methods. On the Web (quick, easy and secure payment on-line) and by "Register" application (off-line).
  150.  
  151. • To register on the web:
  152. Go to the web page http://order.kagi.com/?U3S
  153. 1 - Fill the form with your name, email, address, and how many copies you want.
  154. 2 - Click on the button "Continue" and it will appear the invoice form.
  155. 3 - Fill the fields regarding you Credit-Card datas and then click on the button "Purchase". That's all.
  156.  
  157. If your browser supports, you can switch on SSL secure payment form (it's the internet international standandard secure form of payment).
  158. Kagi will send to you your approved invoice, in round 3 days (usually less than one day). One day after you will receive by me via Email a little TextFile ("RegistrationFile.txt") to put inside the "Plugin" folder (which is into the "FoldersSynchronizer" folder). I use to send the "RegistrationFile.txt" within 24 hours, so if you haven't heard anything most likely you have given us an Invalid Email Address.
  159.  
  160. • To register FoldersSynchronizer off-line by the "Register" application:
  161. You need the "Register" application that accompanies "FoldersSynchronizer" package.
  162. If you lost the "Register" application, you could download it (51Kb) from http://space.tin.it/arte/lpuleo/download/register.sit
  163. Launch the "Register" application, enter your name, email address and the number of single user licenses or other licenses you desire.
  164. Save or copy or print the data from the Register program and send the data and payment to Kagi.
  165. Kagi handles my payment processing. See the end of this document for more specific payment information.
  166. The fastest way (round 3 days) is to save the invoice to a text file, choosing "via email", and therefore send that text file via email as attachment to sales@kagi.com . You can also open the invoice text file with an editor (e.g. SimpleText) select all the text, copy and paste into the email so as it is (without any changement). Don't forget to include your email address. We need to send to you the RegistrationFile by email.
  167. Kagi will send to you your approved invoice, in round 3 days (usually less than one day). One day after you will receive by me via Email a little TextFile ("RegistrationFile.txt") to put inside the "Plugin" folder (which is into the "FoldersSynchronizer" folder). I use to send the "RegistrationFile.txt" within 24 hours, so if you haven't heard anything most likely you have given us an Invalid Email Address.
  168.  
  169.  
  170. Detailed Payment Info:
  171. If paying with Credit Card or First Virtual, you can email or fax the data to Kagi. Their email address is sales@kagi.com and their fax number is +1 510 652-6589. You can either Copy the data from Register and paste into the body of an email message or you can Save the data to a file and you can attach that file to an email message. There is no need to compress the data file, it's already pretty small. If you have a fax modem, just Print the data to the Kagi fax number. 
  172.  
  173. Payments sent via email are processed within 3 to 4 days. You will receive an email acknowledgement when it is processed. Payments sent via fax take up to 10 days and if you provide a correct internet email address you will receive an email acknowledgement. 
  174.  
  175. If you are paying with Cash or USD Cheque you should print the data using the Register application and send it to the address shown on the form, which is: 
  176.  
  177.     Kagi
  178.     1442-A Walnut Street #392-U3S
  179.     Berkeley, California 94709-1405
  180.     USA
  181.  
  182. You can pay with a wide variety of cash from different countries but at present if you pay via cheque, it must be a cheque drawn in US Dollars. Kagi cannot accept cheques in other currencies.
  183.  
  184. If you have a purchasing department, you can enter all the data into the Register program and then select Invoice as your payment method. Print three copies of the form and send it to your accounts payable people. You might want to highlight the line that mentions that they must include a copy of the form with their payment. 
  185. Kagi can not invoice your company, you need to act on my behalf and generate the invoice and handle all the paperwork on your end. 
  186.  
  187. Please do not fax or email payment forms that indicate Cash, Check or Invoice as the payment method. As far as we know, there is still no technology to transfer physical objects via fax or email and without the payment, the form cannot be processed.
  188.  
  189. Payments send via postal mail take time to reach Kagi and then up to 10 days for processing. Again, if you include a correct email address, you will hear from Kagi when the form is processed.
  190.  
  191.  
  192. --
  193. For further informations about the software:
  194. Lorenzo Puleo - Email: archidea@tin.it   -   puleo@kagi.com
  195. Web Site: http://space.tin.it/arte/lpuleo
  196.  
  197. For further informations about the payment:
  198. Kagi - Email: sales@kagi.com  - Web Site: http://www.kagi.com